<div class="md">
    <h1>Duo-Doc说明</h1>
    <p>Duo-Doc是对javadoc的扩展，对代码无入侵，通过读取分析代码注释、项目文件结构，自动提取项目接口、文档信息，并通过一个前端项目（duo-doc-angular）展现。</p>
    <ol>
        <li>自动生成接口文档（支持离线阅读，支持markdown，支持JDK8, JDK9+）</li>
        <li>三方包源码依赖（需要三方包提供-source.jar）</li>
        <li>支持多环境（测试、预发布、生产）的接口直接（RESTful、Dubbo）调用</li>
        <li>支持接口调用参数保存、共享</li>
        <li>生成调用代码（curl / java / javascript）</li>
        <li>RESTful接口Mock（dubbo接口mock有这需求吗？）</li>
        <li>SaaS模式（基于域名隔离）</li>
        <li>...</li>
    </ol>

    <p>如需接入，可参考《<a [routerLink]="['/doc/com.duoec.doc:doclet-server']" [queryParams]="{'r': '/doc/文档接入'}">文档接入帮助</a>》。</p>

    <br><br>

    <h2>JavaDoc</h2>
    <p>
        <a href="https://docs.oracle.com/javase/8/docs/technotes/tools/windows/javadoc.html" target="_blank">Javadoc</a>
        (originally cased JavaDoc) is a documentation generator created by Sun Microsystems for the Java language (now
        owned by Oracle Corporation) for generating API documentation in HTML format from Java source code.
    </p>
    <p class="mb-3">
        在<code>package</code>阶段，利用<code>org.apache.maven.plugins:maven-javadoc-plugin</code> <code>maven</code>插件调用自定义的JavaDoc，解析了源码并将文档需要的信息上报给文档服务器后台。
    </p>

    <h2>后端</h2>
    <p class="mb-3">
        <code>spring-boot</code> / <code>spring-mvc</code>，提供文档上报和WabApplication端数据接口服务<br>
        数据库使用<code>MongoDB (驱动：<a href="https://gitee.com/duoec/common-mongo" target="_blank">common-mongodb</a></code>）<br>
        项目地址：<a href="https://gitee.com/duoec/duo-doc" target="_blank">https://gitee.com/duoec/duo-doc</a>
    </p>

    <h2>前端</h2>
    <p class="mb-3">
        <img src="https://angular.cn/assets/images/logos/angular/logo-nav@2x.png" alt="Angular"><br>
        前端基于<a href="https://angular.io/" target="_blank">Angular</a>框架，缓存并渲染了整个接口文档。本地缓存存储在 <code>LocalStorage</code><br>
    </p>
</div>
